npm发包：极简发包过程演示
NPM Registry号称全世界最大的开源公共仓库，前端生态的丰富性很大程度上依赖它。本节通过一个极简示例演示如何将自己的库发布到npm，供其他开发者使用。
发包前置准备
1. 安装Node.js和npm
确保本地已安装Node.js环境（推荐LTS版本）。
2. 注册NPM账号
前往 npmjs.com 注册账号。重要：注册后必须验证邮箱，否则无法发包。
3. 初始化项目
# 创建项目目录
mkdir my-first-package
cd my-first-package
# 初始化package.json
npm init
bash
npm init会依次询问以下信息：
| 字段 | 说明 | 示例 |
|---|---|---|
| name | 包名（全局唯一） | @scope/package-name 或 my-package |
| version | 初始版本 | 1.0.0 |
| description | 包描述 | A useful CLI tool |
| main | 入口文件 | index.js |
| keywords | 搜索关键词 | cli, tool, utility |
| author | 作者信息 | Your Name <email@example.com> |
| license | 开源协议 | MIT |
也可以使用 npm init -y 快速生成默认配置。
package.json关键字段详解
{
"name": "my-utils-lib",
"version": "1.0.0",
"description": "A collection of utility functions",
"main": "index.js",
"scripts": {
"start": "node index.js",
"test": "echo \"Error: no test specified\" && exit 1"
},
"keywords": ["utils", "helper", "javascript"],
"author": "Your Name <your@email.com>",
"license": "MIT"
}
json
包名规则：
- 必须小写英文，使用短横线连接（kebab-case）
- 不要使用驼峰或大写字母
@scope/package-name格式用于组织包（如@vueuse/core），@前缀代表组织- 发布前可以在npm网站上搜索确认名称是否已被占用
创建.npmignore文件
类似.gitignore，.npmignore用于排除发布时不需要的文件：
# .npmignore
node_modules/
*.log
.DS_Store
src/
tests/
.vscode/
.idea/
*.map
bash
创建README.md
一个清晰的README是包的"门面"，至少包含：
# my-utils-lib
A collection of utility functions.
## Installation
\`\`\`bash
npm install my-utils-lib
\`\`\`
## Usage
\`\`\`javascript
const utils = require('my-utils-lib');
// or
import utils from 'my-utils-lib';
\`\`\`
markdown
发包流程
1. 登录NPM账号
# 首先确认当前使用的是官方源（不是淘宝源）
npm config get registry
# 如果是淘宝源，需要切换回官方源
npm config set registry https://registry.npmjs.org
# 登录
npm login
bash
登录过程会打开浏览器进行身份验证，支持双因素认证（2FA）。终端显示Logged in as <username>即表示登录成功。
2. 发布
npm publish
bash
看到 + package-name@1.0.0 输出即表示发布成功。
3. 验证
# 使用npm search搜索
npm search your-package-name
# 直接安装测试
npm install your-package-name
bash
注意：网页上搜索可能有延迟，这属于正常现象。
撤回已发布的包
# 24小时内可以撤回
npm unpublish package-name@1.0.0 -f
# 撤回所有版本
npm unpublish package-name -f
bash
注意：npm对垃圾包有清理机制，空包可能无法被搜索到。撤回操作只支持在发布后24小时内执行。
更新已发布的包
# 修改代码后，更新版本号
npm version patch # bug修复
npm version minor # 新功能
npm version major # 破坏性变更
# 重新发布
npm publish
bash
常见问题与注意事项
| 问题 | 原因 | 解决方案 |
|---|---|---|
| 发布失败403 | 邮箱未验证 | 去npmjs.com验证邮箱 |
| 包名已存在 | 名称被占用 | 换一个名称或使用@scope |
| 发布到淘宝源 | registry配置错误 | 切换到官方源再发布 |
| 版本号未更新 | 重复发布同版本 | 先执行npm version |
| .npmignore无效 | 文件名拼写错误 | 确认是.npmignore |
AI辅助发包工具（2026补充）
| 工具 | 功能 | 价格 |
|---|---|---|
| changeset | 自动化版本管理和CHANGELOG生成 | 开源免费 |
| semantic-release | 基于commit信息自动发布 | 开源免费 |
| np | 交互式发包流程，自动检查 | 开源免费 |
推荐使用 np 简化发包流程，它会自动执行检查、运行测试、创建标签、发布等一系列操作：
npx np
bash
↑